# User Match Details

> `GET /api/user/matches/{match_id}`: User endpoint of the Rone Arena API.

**Deprecated:** still answers, but will not receive further work. Prefer another endpoint.

**Sign-in required:** send `Authorization: Bearer <jwt>`. Get the JWT from `POST /api/user/auth/send-vc` then `POST /api/user/auth/login`.

Retrieve the authenticated player's detailed match information using a valid JWT. Supports query parameters for season filtering and localization. Requires an Authorization header with the JWT from login.

Headers:
- **Authorization**: `Bearer <jwt>` (JWT obtained during login).

Path parameters:
- **match_id**: Unique identifier of the match (from `bid_s` in `/api/user/matches`).

Query parameters:
- **sid**: Season ID for filtering (must be a valid season ID from `/api/user/season`).
- **lang**: Language code for localized content (default: `en`).

The response includes per-player match details:
- **f**: Team flag (1 = Team A, 2 = Team B).
- **hid**: Hero ID used in the match.
- **rid**: Role ID (unique player identifier).
- **zid**: Zone ID (server region).
- **k**: Kills.
- **d**: Deaths.
- **a**: Assists.
- **tfr**: Team Fight Rate (contribution ratio in team fights, `tfr*100`%).
- **o**: Output (total damage dealt or hero damage).
- **op**: Output Percentage (damage contribution relative to team).
- **s**: Score (performance rating, `s/100`).
- **mvp**: MVP flag (1 if MVP, 0 otherwise).
- **its**: Item IDs equipped during the match.
- **its_e**: Item entity metadata:
    - **id**: Item ID.
    - **n**: Item name.
    - **ix**: Item image URL.
    - **i2x**: Large item image URL.
- **eq**: Equipment slot indicator.
- **ts**: Timestamp of the match.
- **bd**: Battle duration (seconds).
- **fk**: First Kill flag (total kills in a team).
- **fw**: First Win flag (`1` for Win, `0` for Loss).
- **hid_e**: Hero entity metadata:
    - **id**: Hero ID.
    - **n**: Hero name.
    - **ix**: Hero image URL.
    - **i2x**: Large hero image URL.
- **hlvl**: Hero level reached in the match.
- **rname**: Role name (localized string, e.g., 'ジャングラー').

This endpoint provides a full breakdown of each participant in the match, including:
    - Hero choice.
    - Performance stats (kills, deaths, assists, damage).
    - Items built with metadata.
    - Role assignment and team contribution.

It is useful for:
    - Reconstructing match history.
    - Analyzing team compositions.
    - Evaluating player performance in detail.

## Request

`GET https://arena.rone.dev/api/user/matches/{match_id}`

### Parameters

| Name | In | Type | Required | Default | Description |
| --- | --- | --- | --- | --- | --- |
| `match_id` | path | integer | yes |  | The unique identifier of the match to retrieve details for. |
| `sid` | query | integer | yes |  | The season ID for filtering recent matches. |
| `lang` | query | string | no | `en` | Language code for localized content. One of: `en`, `id`, `ru`, `es`, `pt`, `tr`, `ar`, `de`, `fr`, `it`, `ja`, `ko`, `th`, `vi`, `zh-CN`, `zh-TW`, `km`. |

### Example

```bash
curl -X GET 'https://arena.rone.dev/api/user/matches/{match_id}?sid=<sid>' \
  -H 'Authorization: Bearer <jwt>'
```

## Example response

```json
{
  "code": 0,
  "message": "Success",
  "traceID": "4d96357b092ade76774481366567bcaf",
  "data": {
    "result": [
      {
        "f": 2,
        "hid": 31,
        "rid": 1880233572,
        "zid": 57027,
        "k": 4,
        "d": 9,
        "a": 6,
        "tfr": 0.4167,
        "o": 83974,
        "op": 0.2202,
        "s": 509,
        "mvp": 0,
        "its": [
          2305,
          3002,
          3005,
          3015,
          3003,
          3013,
          0
        ],
        "eq": 0,
        "ts": 1773837471,
        "bd": 1292,
        "fk": 24,
        "fw": 0,
        "hid_e": {
          "id": 31,
          "n": "Moskov",
          "ix": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fgms%2Fimage%2F5c4587c25e681be1aecfda0cfbe44714.png",
          "i2x": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Ffile%2Fmlbb%2Fhomepage%2F100_843f1c2c3a1b2d4da2fc2ec73cf47cfa.jpg"
        },
        "its_e": [
          {
            "id": 2305,
            "n": "Swift Boots",
            "ix": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fhomepage%2F100_b31a355cc85682eed8d9e0dc163fd756.png",
            "i2x": ""
          },
          null
        ],
        "hlvl": 15,
        "rname": "\u1d35\u1d50\u0166ungi\u2113"
      }
    ]
  }
}
```

## Links

- Try it in the playground: https://arena.rone.dev/web/user/matches/{match_id}
- User endpoints: https://arena.rone.dev/web/user.md
- OpenAPI schema: https://arena.rone.dev/api/openapi.json
